home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / util / misc / TUDE.lha / TUDE / tude.doc < prev    next >
Text File  |  1994-09-21  |  17KB  |  507 lines
  1.  
  2.        The Ultimate Degrader & Enhancer Version 1.0d by N.O.M.A.D
  3.        
  4.                              Documentation
  5.  
  6.  
  7.    Forward   
  8.    -------
  9.    This is my latest work, since i gave up cracking in January 1994
  10.    i have been able to sort out my life and i am off to college in a 
  11.    week or so, because of the nature of my course i need to buy an 
  12.    IBM compatible PC, the amiga im afraid is to be sold to pay for
  13.    a 486 DX2/66.
  14.  
  15.    This program has been sitting on my hardrive for a while, i HAVE
  16.    to release it in its BETA form, or it will never get released at
  17.    all, i may be able to afford to buy another amiga in a year or two
  18.    but college is my main priority.
  19.  
  20.    Enjoy this program, and feel free to update it, but please remember
  21.    to at least credit me for my work on it, after all it will be my 
  22.    last Amiga project for a while, in fact i may never return to the
  23.    Amiga, who knows?
  24.  
  25.  
  26.    To my friends in the amiga scene, and to all the crews i have cracked
  27.    (deprotected) software for:
  28.  
  29.      FAIRLIGHT,MINISTRY,QUARTEX,CRYSTAL,DEFJAM & ANGELS,GENESIS,SCOOPEX
  30.  
  31.    Thankyou.
  32.  
  33.               N.O.M.A.D
  34.  
  35.  
  36.  
  37.    Chapter                              
  38.    -------
  39.      1.   About
  40.  
  41.      2.   Copyrights & Distribution details
  42.  
  43.      3.   TUDE options and their uses
  44.  
  45.  
  46.                              Chapter 1.
  47.                              ----------
  48.              - About The Ultimate Degrader & Enhancer -
  49.  
  50.  TUDE has been in development for a few months, i needed a degrader
  51. type program that offered more flexibility than any of the currently 
  52. available programs (Relokick, my own RunIt, Degrader, Runlame etc.),
  53. in one easy to use package. So TUDE was born.
  54.  
  55. Two versions of TUDE are included, a CLI version and a GUI version. 
  56.  
  57.  
  58.                              Chapter 2.
  59.                              ----------
  60.                 - Copyright & distribution notices -
  61.  
  62.  
  63. The Ultimate Degrader & Enhancer (TUDE) is Copyrighted material.
  64. TUDE is copyrighted by N.O.M.A.D and is available as Freeware.
  65. TUDE is freely distributable provided the following rules are respected:
  66.  
  67.  1.  No charge except reasonable media costs may be levied.
  68.  2.  The program and documentation may not be modified in any way.
  69.  
  70. I am in no way liable for damages, incidental or consequential, arising
  71. from the use or misuse of The Ultimate Degrader & Enhancer, or for any
  72. claim by any other party.
  73. Use this program at your own risk.
  74. No warranty is given either expressed or implied.
  75. Copyright and distribution terms are subject to change without notice.
  76.  
  77.  
  78.  
  79.                              Chapter 3.
  80.                              ----------
  81.                   - TUDES options and their uses -
  82.  
  83.  
  84. TUDEGUI is a Gadget User Interface version of TUDE
  85. TUDE    is the CLI version of tude
  86.  
  87. NOTE: TUDE must be in your C: directory for the TUDEGUI to work.
  88.       The kickstart 1.3 file (kick34005.a500) must be in your SYS:
  89.       directory or in DEVS:KICKSTARTS
  90.  
  91.  
  92. HELP
  93. ----
  94. Option type: 
  95. --------------
  96. This option will display simple instructions for each of the options
  97. available in TUDE, a more detailed explanation for each option is
  98. contained in these docs.
  99.  
  100.  
  101.  
  102. PRIVILEGED
  103. ----------
  104. Option type: PATCH
  105. ------------------
  106. Since the 68010, certain CPU instructions must be run in supervisor
  107. mode or they will cause what is know as a privileged error.
  108. This option intercepts the error and executes the instruction as
  109. the 68000 would. 
  110.  
  111. If the software you are using continually crashes with error 80000008
  112. or just crashes for no reason, try this option.
  113.  
  114.  
  115.  
  116. MMURESET
  117. --------
  118. Option Type: Run Once
  119. ---------------------
  120. If you have a 68851 or a full 680x0 CPU i.e. not the EC version, it
  121. will have some special hardware called a Memory Management Unit, this
  122. allows the user to remap areas of memory to another address, write
  123. protect memory and other useful options.
  124. This option resets the MMU to its default values so that the memory
  125. is in its original bootup state. NOTE: If you are using the MMU to
  126. remap kickstart to fast memory, this option will crash your machine
  127. ( for obvious reasons ! ).
  128.  
  129. There is no real way of detecting if the MMU is to blame for your
  130. softwares failure, just try the option.
  131.  
  132.  
  133.  
  134. BLANKVIEW
  135. ---------
  136. Option Type: Run Once
  137. ---------------------
  138. This option resets the display to a blank ECS type screen, it will
  139. stay in this state until the software opens its own.
  140.  
  141. Since the release of kickstart 3 and the AGA chipset, many programs
  142. suffer a corrupt screen problem when run from HardDrive or Workbench.
  143. This will cure the problem 90% of the time, however use of the CHIPSET
  144. or FMODE options in conjunction with BLANKVIEW will cure the remaining
  145. 10%.
  146.  
  147.  
  148.  
  149. OSPATCHOLD
  150. ----------
  151. Option Type: PATCH
  152. ------------------
  153. This option patches certain library vectors to return OS1.3 values
  154. without the need to kickup in kickstart 1.3
  155.  
  156. Some software relies heavily on the values being returned by the OS
  157. to be the same as kickstart 1.3, a perfect example of return value
  158. differences is in kickstart 2.0+'s memory routines. If the software
  159. fails due to memory problems or just fails for no reason, try this
  160. option
  161.  
  162.  
  163.  
  164. NOFASTMEMORY
  165. ------------
  166. Option Type: PATCH
  167. ------------------
  168. This option allocates all the fast memory it can, and patches the OS
  169. so that any programs that allocate memory only get chipram.
  170.  
  171. Some programs will not run with fast memory, especially if run on
  172. A4000/A3000 and CD32's. In the majority of cases, no error will be
  173. given the software will just crash, just try this option if others fail.
  174.  
  175.  
  176.  
  177. HARDRESET
  178. ---------
  179. Option Type: Run Once
  180. ---------------------
  181. This option Resets the CPU - all attached peripherals & Execbase, your machine will be in the same state as it was when you first powered on.
  182.  
  183. If after running some software, your machine behaves weird, use this
  184. option, saves you having to power off all the time!
  185. As a side effect, it kills all known viruses DEAD
  186.  
  187.  
  188.  
  189. KICKSTART1.3
  190. ------------
  191. Option Type: Run Once
  192. ---------------------
  193. This option will "kickdown" your machine to kickstart 1.3 with ANY
  194. of TUDES available options i.e. PRIVILEGED, CHIPMEM=512k, NOFASTMEMORY
  195. etc. This makes it a VERY powerful option.
  196.  
  197. KICKSTART1.3 DEGRADE will be one of your most used options, if software
  198. is going to work without alteration, this will probably do it!
  199.  
  200.  
  201.  
  202. MEMTOP
  203. ------
  204. Option Type: Run Once
  205. ---------------------
  206. This option affects all TUDES PATCH options, it forces them to take
  207. their memory from the top of the memory list.
  208. NOTE: Kickstart 2.0 or above needed.
  209.  
  210. Even though programs can be fixed with TUDES options, sometimes
  211. the patches will be overwritten if in lower memory, this stops that
  212. happening by placing them high up in the available memory.
  213.  
  214.  
  215.  
  216. MEMCHIP
  217. -------
  218. Option Type: Run Once
  219. ---------------------
  220. This option affects all TUDES PATCH options, it forces them to take
  221. their memory from ChipRam. MEMTOP & MEMCHIP can be mixed.
  222. NOTE: Kickstart 2.0 or above needed.
  223.  
  224. Even though programs can be fixed with TUDES options, sometimes
  225. the patches will be overwritten if in FAST memory, this stops that
  226. happening by placing them in ChipRam.
  227.  
  228.  
  229.  
  230. DEGRADE
  231. -------
  232. Option Type: Run Once
  233. ----------------------
  234. This option checks the machine it is running on and selects what it
  235. thinks are the best options to degrade the machine as much as possible.
  236.  
  237. If you have not got a clue why software fails, try this option.
  238.  
  239.  
  240.  
  241. ENHANCE
  242. -------
  243. Option Type: Run Once
  244. ---------------------
  245. This option checks the machine it is running on and selects what it
  246. thinks are the best options to enhance the machine as much as possible.
  247.  
  248. If you want to turn on all the available power in your machine, this
  249. is for you!
  250.  
  251.  
  252.  
  253. OPTFILE=<filename>
  254. ------------------
  255. Option Type: Run Once
  256. ----------------------
  257. This option reads in an ASCII textfile and passes it as commands for
  258. TUDE to execute.
  259.  
  260. If you are a cli user, once you have found out what makes a particular
  261. piece of software run, create a textfile with the options needed
  262. and just use it with TUDE via this option.
  263. Saves all that retyping!
  264.  
  265.  
  266.  
  267. FAKEFAST=[1|2|3]
  268. ----------------
  269. Option type: Run Once
  270. ---------------------
  271. This option gives chipram only machines fast memory by fooling the OS
  272. into thinking that any chipram above a certain address is fastmemory.
  273. The amount of fake fast depends on the number after the FAKEFAST
  274. command word.
  275.  
  276. FAKEFAST=1 gives 1meg+ chipram machines 512k  chip & rest of ram is fast
  277. FAKEFAST=2 gives 2meg  chipram machines 1024k chip & rest of ram is fast
  278. FAKEFAST=1 gives 2meg  chipram machines 1536k chip & rest of ram is fast
  279.  
  280. It can also be used before the KICKSTART1.3 option is called to give
  281. you fakefast memory AFTER kicking up.
  282.  
  283. Its usage is varied, it will obviously help in nofastram errors, but can
  284. also help older software that relies on certain chipram address's being
  285. free, by relocating execbase into fakefast.
  286.  
  287.  
  288.  
  289. CHIPSET=[OLD|ECS|AGA|BEST]
  290. --------------------------
  291. Option Type: Run Once
  292. ---------------------
  293. This option will emulate the specified chipset if the hardware will
  294. allow. Currently AGA can emulate the OLD and ECS chipsets, and ECS 
  295. can emulate the OLD chipset.
  296. CHIPSET=OLD  On AGA/ECS machines the original chipset will be emulated
  297. CHIPSET=ECS  On AGA/ECS machines the enhanced chipset will be emulated
  298. CHIPSET=AGA  On AGA/ECS machines the AGA chipset will be selected
  299. CHIPSET=BEST The chipsets best features will be enabled.
  300.  
  301. NOTE: Unlike other degraders such as RunIt, TUDE's chipset option
  302.       still works AFTER the Workbench 3 setpatch command has been run.
  303.       TUDE's chipset option will affect ALL newly opened screens,              currently opened screens retain their chipset values.
  304.  
  305. It can be used to stop corrupt graphics on AGA/ECS machines, or to turn
  306. on AGA features for older software.
  307.  
  308. See Also: BLANKVIEW
  309.  
  310.  
  311.  
  312. BOOT=[LOWCHIP|HIGHCHIP|LOWFAST|HIGHFAST]
  313. ----------------------------------------
  314. Option Type: Run Once
  315. ---------------------
  316. This option allows the user to "bootup" a disk in the internal drive
  317. with any of TUDE's options. The type of memory that the bootblock is
  318. read into can also be altered.
  319.  
  320. BOOT=LOWCHIP   Read bootblock into lowchip  memory and boot disk
  321. BOOT=HIGHCHIP  Read bootblock into highchip memory and boot disk
  322. BOOT=LOWFAST   Read bootblock into lowfast  memory and boot disk
  323. BOOT=HIGHFAST  Read bootblock into highfast memory and boot disk
  324.  
  325. REMEMBER: Any of TUDE's options can be used before booting up disk.
  326.  
  327. Apart from using this to boot up a disk with TUDE's options,
  328. some software expects the bootblock to be either in chipram, or for 
  329. certain areas of memory to be free and unused by the OS, obviously
  330. if a bootblock reads data over its own code, or over the OS libraries
  331. it will cause a software failure.
  332.  
  333.  
  334.  
  335. FMODE=[1x|2x|3x|4x]
  336. -------------------
  337. Option Type: Run Once
  338. ---------------------
  339. This option alters the AGA chipsets fetchrate from chipram, for the 
  340. higher fetchrates data must be aligned to 64bit boundaries, lower
  341. fetchrates allow data to be on 16bit boundaries.
  342.  
  343. FMODE=1x  Set AGA graphics fetchrate to OLD & ECS values
  344. FMODE=2x  Set AGA graphics fetchrate to 32bits
  345. FMODE=3x  Set AGA graphics fetchrate to 32bits +
  346. FMODE=4x  Set AGA graphics fetchrate to 64bits
  347.  
  348. NOTE: Although other degraders such as RunIt & Embedder have this 
  349.       option, theirs will only alter the fetchmode while the
  350.       screen is blanked, TUDE's fmode option will affect ALL
  351.       newly opened screens, currently opened screens retain
  352.       their fetchmode values.
  353.  
  354. The fetchmode can cause havoc with certain software, all you see is
  355. garbage on the screen or corrupt sprites, use the FMODE=1x option
  356. to reset the fetchmode for all NEWLY opened screens to OLD/ECS rates.
  357.  
  358. You could also use it with older software to help speed up GFX, use
  359. the FMODE=2x to FMODE=4x options
  360.  
  361. See Also: BLANKVIEW
  362.  
  363.  
  364.  
  365. VIEW=[VGA|PRODUCT|DBLPAL|DBLNTSC]
  366. ---------------------------------
  367. Option type: PATCH
  368. ------------------
  369. This option forces all screens that are opened via the OS to use a
  370. certain monitor type, in kickstart 3.0 the actual monitor driver
  371. MUST be in DEVS:
  372.  
  373. VIEW=VGA      Force all screens opened via the OS to use VGA
  374. VIEW=PRODUCT  Force all screens opened via the OS to use PRODUCTIVITY 
  375. VIEW=DBLPAL   Force all screens opened via the OS to use DBLPAL 
  376. VIEW=DBLNTSC  Force all screens opened via the OS to use DBLNTSC
  377.  
  378. If you are using a VGA monitor or the software you are using does
  379. not support the screen mode you want, use this option.
  380.  
  381.  
  382.  
  383. HERTZ=[HWPAL|HWNTSC|OSPAL|OSNTSC|PAL|NTSC]
  384. ------------------------------------------
  385. Option Type: Run Once
  386. ---------------------
  387. This option will force the display and/or OS to function as if it
  388. were an NTSC or PAL machine.
  389.  
  390. HERTZ=HWPAL   Go into PAL  mode via ECS/AGA chipset
  391. HERTZ=HWNTSC  Go into NTSC mode via ECS/AGA chipset
  392. HERTZ=OSPAL   Patch OS to think it is a pal machine   
  393. HERTZ=OSNTSC  Patch OS to think it is a ntsc machine
  394. HERTZ=PAL     Patch OS and go into pal  via the ECS/AGA chipset
  395. HERTZ=NTSC    Patch OS and go into ntsc via the ECS/AGA chipset
  396.  
  397. This has various uses, from making software intended for PAL use to 
  398. work on NTSC machines ( and NTSC software on PAL machines), to making
  399. software run faster and use the full screen vertically.
  400.  
  401.  
  402.  
  403. VBASE=[ZERO|FAST]
  404. -----------------
  405. Option Type: Run Once
  406. ---------------------
  407. Since the 68010, the vector locations for interrupts and exceptions
  408. can be moved to any location in chip or fast ram, this option will
  409. either reset them to the 68000 location, or move them to fast ram.
  410.  
  411. VBASE=ZERO  Set vector locations to zero  ( 68000 )
  412. VBASE=FAST  Set vectors locations to Fast ram
  413.  
  414. The VBASE=ZERO option will fix most software ran from HD on 68040
  415. based machines such as the A4000, if software has no music or display
  416. does not seem to update correctly, try this option.
  417.  
  418. The VBASE=FAST option can be used to speed up software, but only
  419. if you have true fast ram, and the software will run correctly with
  420. the vector base altered.
  421.  
  422.  
  423.  
  424. FILTER=[OFF|ON]
  425. ---------------
  426. Option Type: Run Once
  427. ---------------------
  428. This option enables the user to turn the lowpass audio filter on and
  429. off, both have their advantages.
  430.  
  431. FILTER=OFF   Turn off the lowpass audio filter for clearer sound
  432. FILTER=ON    Turn on  the lowpass audio filter to stop distortion
  433.  
  434. You can use this option to makes sounds sharper and clearer in your
  435. games software, or to help stop distortion on gritty samples.
  436.  
  437.  
  438.  
  439. CHIPMEM=[512k|1024k]
  440. --------------------
  441. Option Type: Run Once
  442. ---------------------
  443. This option reduces chip ram to specified values.
  444.  
  445. CHIPMEM=512k  Reduce chipram to 512k
  446. CHIPMEM=1024k Reduce chipram to 1024k
  447.  
  448. Older software, especially games, will crash when more than 512k of
  449. chipram is available, there are no tell tale signs, just try it!
  450.  
  451.  
  452.  
  453. CACHES=[NONE|ALL|NOINS|NODATA|INSON|DATAON]
  454. -------------------------------------------
  455. Option Type: Run Once
  456. ---------------------
  457. This option manipulates the cache memory on the 68020+, data caches can
  458. only be altered on the 68030+.
  459.  
  460. CACHES=NONE   : Turn off all CPU caches on 68020+
  461. CACHES=ALL    : Turn on  all CPU caches on 68020+
  462. CACHES=NOINS  : Turn off CPU instruction cache on 68020+
  463. CACHES=NODATA : Turn off CPU data cache on 68030
  464. CACHES=INSON  : Turn on  CPU instruction cache on 68020+
  465. CACHES=DATA   : Turn on  CPU data cache on 68030+
  466.  
  467. The CPU caches cause a lot of problems on older software, self altering
  468. code, CPU delay loops, all fail on 68020+, turning off the caches helps
  469. this software to run correctly.
  470.  
  471. To make software run faster, turn on the caches, remember the data cache
  472. is not enabled on 68030/40 A4000 until the setpatch command has run.
  473.  
  474.  
  475.  
  476. BORDER=[NORM|BLANK]
  477. -------------------
  478. Option Type: Run Once
  479. ---------------------
  480. This option will allow the genlocking of AGA to be turned on or off.
  481. A side affect of using this option without genlock data coming in, is
  482. a completely black border with does improve contrast!
  483.  
  484. BORDER=NORM   : Border area is in normal OCS/ECS state",$a
  485. BORDER=BLANK  : Border area is in Blank/genlock state",$a    
  486.  
  487. If the video software you are using fails to work in genlock mode
  488. correctly, use the BORDER=BLANK option, if the genlock interfere's
  489. with software that it should not, use the BORDER=NORM option.
  490.  
  491.  
  492.  
  493. SPRITE=[OCS|ECS|70NS|35NS|DEF]
  494. ------------------------------
  495. Option Type: Run Once
  496. ---------------------
  497. This options alters the resolution of the amiga's hardware sprites.
  498.  
  499. SPRITE=OCS    : Reset Sprite resolution to OCS state",$a
  500. SPRITE=ECS    : Reset Sprite resolution to ECS multistate",$a
  501. SPRITE=70NS   : Reset AGA/ECS Sprites to HIRES resoltion",$a
  502. SPRITE=35NS   : Reset AGA/ECS Sprites to SHIRES resoltion",$a
  503. SPRITE=DEF    : Reset AGA/ECS Sprites to default WB value",$a
  504.  
  505. If you have corrupt sprites, or they are too small/big for the screen
  506. they are on, using one of these options will correct the fault.
  507.